Skip to main content
Version: 0.6.0

Types

All object types, interfaces, and enums in the TFGQL schema.

Object Types

Interfaces

Enums


AdminUser

Represents a user managed through the Terraform Enterprise admin APIs.

FieldTypeDescription
idID!
usernameString!
emailString
avatarUrlString
isServiceAccountBoolean!
isAdminBoolean!
isSuspendedBoolean!
organizations[Organization!]!
teams(includeOrgs: [String!], excludeOrgs: [String!], filter: TeamFilter)[Team!]!

Agent

FieldTypeDescription
idID!
nameString
statusString!
ipAddressString!
lastPingAtDateTime!

AgentPool

FieldTypeDescription
idID!
typeString!
nameString!
createdAtDateTime!
organizationScopedBoolean!
agentCountInt!
workspaces(filter: WorkspaceFilter)[Workspace!]!
allowedWorkspaces(filter: WorkspaceFilter)[Workspace!]!
agents(filter: AgentFilter)[Agent!]!
authenticationTokens(filter: AgentTokenFilter)[AgentToken!]!

AgentToken

FieldTypeDescription
idID!
poolIdString
createdAtDateTime!
lastUsedAtDateTime
descriptionString!
createdByIdID!

Apply

FieldTypeDescription
idID!
modeString
statusString!
queuedAtDateTime
startedAtDateTime
finishedAtDateTime
logReadUrlString!
applyLog(minimumLevel: LogLevel)[JSON!]
structuredRunOutputEnabledBoolean!
resourceAdditionsInt
resourceChangesInt
resourceDestructionsInt
resourceImportsInt
stateVersions(filter: StateVersionFilter)[StateVersion!]!

AssessmentResult

FieldTypeDescription
idID!
driftedBoolean!
succeededBoolean!
errorMessageString
createdAtDateTime!

Comment

FieldTypeDescription
idID!
bodyString!
runEventIdID

ConfigurationVersion

FieldTypeDescription
idID!
autoQueueRunsBoolean!
errorString
errorMessageString
provisionalBoolean!
sourceString
speculativeBoolean!
statusString!
statusTimestampsConfigurationVersionStatusTimestamps
changedFiles[String!]!
ingressAttributesIngressAttributes
sizeInt
downloadUrlString

ConfigurationVersionStatusTimestamps

FieldTypeDescription
archivedAtDateTime
fetchingAtDateTime
uploadedAtDateTime

ExplorerModuleRow

FieldTypeDescription
nameString
sourceString
versionString
workspaceCountInt
workspacesString
organizationOrganization
workspaceEntities(filter: WorkspaceFilter)[Workspace!]!

ExplorerProviderRow

FieldTypeDescription
nameString
sourceString
versionString
workspaceCountInt
workspacesString
organizationOrganization
workspaceEntities(filter: WorkspaceFilter)[Workspace!]!

ExplorerTerraformVersionRow

FieldTypeDescription
versionString
workspaceCountInt
workspacesString
organizationOrganization
workspaceEntities(filter: WorkspaceFilter)[Workspace!]!

ExplorerWorkspaceRow

FieldTypeDescription
allChecksSucceededBoolean
currentRumCountInt
checksErroredInt
checksFailedInt
checksPassedInt
checksUnknownInt
currentRunAppliedAtDateTime
currentRunExternalIdString
currentRunStatusString
driftedBoolean
externalIdString
moduleCountInt
modulesString
organizationNameString
projectExternalIdString
projectNameString
providerCountInt
providersString
resourcesDriftedInt
resourcesUndriftedInt
stateVersionTerraformVersionString
tagsString
vcsRepoIdentifierString
workspaceCreatedAtDateTime
workspaceNameString
workspaceTerraformVersionString
workspaceUpdatedAtDateTime
workspaceWorkspace
projectProject
currentRunRun
organizationOrganization

IngressAttributes

Commit metadata for VCS-based configuration versions.

FieldTypeDescription
idID!
branchString
cloneUrlString
commitMessageString
commitShaString
commitUrlString
compareUrlString
identifierString
isPullRequestBoolean
onDefaultBranchBoolean
pullRequestNumberInt
pullRequestUrlString
pullRequestTitleString
pullRequestBodyString
tagString
senderUsernameString
senderAvatarUrlString
senderHtmlUrlString
createdByString

Organization

FieldTypeDescription
idID!
nameString!
externalIdString!
emailString!
createdAtDateTime!
sessionTimeoutInt
sessionRememberInt
collaboratorAuthPolicyString!
planExpiredBoolean!
planExpiresAtDateTime
planIsTrialBoolean
planIsEnterpriseBoolean
planIdentifierString
costEstimationEnabledBoolean!
sendPassingStatusesForUntriggeredSpeculativePlansBoolean!
aggregatedCommitStatusEnabledBoolean!
speculativePlanManagementEnabledBoolean!
allowForceDeleteWorkspacesBoolean!
fairRunQueuingEnabledBoolean!
samlEnabledBoolean!
ownersTeamSamlRoleIdString
twoFactorConformantBoolean!
assessmentsEnforcedBoolean!
defaultExecutionModeString!
permissionsOrganizationPermissions!
workspaces(filter: WorkspaceFilter)[Workspace!]
teams(filter: TeamFilter)[Team!]
users(filter: UserFilter)[User!]
variableSets(filter: VariableSetFilter)[VariableSet!]
memberships(filter: OrganizationMembershipFilter)[OrganizationMembership!]!
tags(filter: OrganizationTagFilter)[OrganizationTag!]!
policySets(filter: PolicySetFilter)[PolicySet!]
usersFromAdmin(filter: UserFilter)[AdminUser!]
projects(filter: ProjectFilter)[Project!]

OrganizationMembership

FieldTypeDescription
idID!
statusString!
organizationIdID!
userIdID!
teamIds[ID!]!

OrganizationPermissions

FieldTypeDescription
canUpdateBoolean!
canDestroyBoolean!
canAccessViaTeamsBoolean!
canCreateModuleBoolean!
canCreateTeamBoolean!
canCreateWorkspaceBoolean!
canManageUsersBoolean!
canManageSubscriptionBoolean!
canManageSsoBoolean!
canUpdateOauthBoolean!
canUpdateSentinelBoolean!
canUpdateSshKeysBoolean!
canUpdateApiTokenBoolean!
canTraverseBoolean!
canStartTrialBoolean!
canUpdateAgentPoolsBoolean!
canManageTagsBoolean!
canManageVarsetsBoolean!
canReadVarsetsBoolean!
canManagePublicProvidersBoolean!
canCreateProviderBoolean!
canManagePublicModulesBoolean!
canManageCustomProvidersBoolean!
canManageRunTasksBoolean!
canReadRunTasksBoolean!
canCreateProjectBoolean!

OrganizationTag

FieldTypeDescription
idID!
nameString!
createdAtDateTime!
instanceCountInt!

Plan

FieldTypeDescription
idID!
modeString!
agentIdID
agentNameString
agentPoolIdID
agentPoolNameString
generatedConfigurationBoolean!
hasChangesBoolean!
resourceAdditionsInt!
resourceChangesInt!
resourceDestructionsInt!
resourceImportsInt!
statusString!
logReadUrlString!
planLog(minimumLevel: LogLevel)[JSON!]
planExportDownloadUrlString
structuredRunOutputEnabledBoolean!
jsonOutputUrlString
jsonOutputRedactedString
jsonSchemaString
agentQueuedAtDateTime
pendingAtDateTime
startedAtDateTime
finishedAtDateTime

Policy

FieldTypeDescription
idID!
nameString!
descriptionString
kindString!
queryString
enforcementLevelString!
policySetCountInt!
updatedAtDateTime

PolicyCheck

FieldTypeDescription
idID!
statusString!
scopeString!
resultJSON!
sentinelJSON
statusTimestampsPolicyCheckStatusTimestamps!
permissionsPolicyCheckPermissions!
actionsPolicyCheckActions!
createdAtDateTime
finishedAtDateTime
outputUrlString
runRun!

PolicyCheckActions

FieldTypeDescription
isOverridableBoolean!

PolicyCheckPermissions

FieldTypeDescription
canOverrideBoolean!

PolicyCheckStatusTimestamps

FieldTypeDescription
queuedAtDateTime
passedAtDateTime
hardFailedAtDateTime
softFailedAtDateTime
advisoryFailedAtDateTime
overriddenAtDateTime

PolicyEvaluation

FieldTypeDescription
idID!
statusString!
policyKindString!
resultCountPolicyEvaluationResultCount!
statusTimestampsPolicyEvaluationStatusTimestamps!
createdAtDateTime!
updatedAtDateTime!
policyAttachableIdID
policySetOutcomes[PolicySetOutcome!]!

PolicyEvaluationResultCount

Counts of policy evaluation results, grouped by outcome.

FieldTypeDescription
advisoryFailedInt!
erroredInt!
mandatoryFailedInt!
passedInt!

PolicyEvaluationStatusTimestamps

Timestamps for each policy evaluation status transition.

FieldTypeDescription
queuedAtDateTime
runningAtDateTime
passedAtDateTime
erroredAtDateTime

PolicySet

A collection of policies that can be applied to Terraform Cloud workspaces.

FieldTypeDescription
idID!
nameString!
descriptionString
kindString!
globalBoolean!
agentEnabledBoolean!
policyToolVersionString!
overridableBoolean!
workspaceCountInt!
projectCountInt!
policyCountInt
policiesPathString
versionedBoolean!
vcsRepoPolicySetVcsRepo
createdAtDateTime!
updatedAtDateTime!
organizationOrganization!
policies(filter: PolicyFilter)[Policy!]!
projects(filter: ProjectFilter)[Project!]!
workspaces(filter: WorkspaceFilter)[Workspace!]!
workspaceExclusions(filter: WorkspaceFilter)[Workspace!]!
parameters(filter: PolicySetParameterFilter)[PolicySetParameter!]!

PolicySetOutcome

FieldTypeDescription
idID!
outcomesJSON
errorString
warnings[JSON!]!
overridableBoolean!
policySetNameString!
policySetDescriptionString
resultCountPolicySetOutcomeResultCount!

PolicySetOutcomeResultCount

FieldTypeDescription
advisoryFailedInt!
mandatoryFailedInt!
passedInt!
erroredInt!

PolicySetParameter

FieldTypeDescription
idID!
keyString!
valueString
sensitiveBoolean!
categoryString!

PolicySetVcsRepo

VCS repository configuration for a policy set.

FieldTypeDescription
branchString
identifierString!
ingressSubmodulesBoolean!
oauthTokenIdString
githubAppInstallationIdString

Project

FieldTypeDescription
idID!
nameString!
descriptionString
createdAtDateTime
workspaceCountInt
teamCountInt
stackCountInt
autoDestroyActivityDurationString
defaultExecutionModeString
settingOverwritesSettingOverwrites
permissionsProjectPermissions
organizationOrganization
workspaces(filter: WorkspaceFilter)[Workspace!]!
teams(filter: TeamFilter)[Team!]!
variableSets(filter: VariableSetFilter)[VariableSet!]!
teamAccess(filter: ProjectTeamAccessFilter)[ProjectTeamAccess!]!

ProjectAccess

FieldTypeDescription
settingsString!
teamsString!

ProjectPermissions

FieldTypeDescription
canReadBoolean
canUpdateBoolean
canDestroyBoolean
canCreateWorkspaceBoolean
canMoveWorkspaceBoolean
canMoveStackBoolean
canDeployNoCodeModulesBoolean
canReadTeamsBoolean
canManageTagsBoolean
canManageTeamsBoolean
canManageInHcpBoolean
canManageEphemeralWorkspaceForProjectsBoolean
canManageVarsetsBoolean

ProjectTeamAccess

FieldTypeDescription
idID!
accessString!
projectAccessProjectAccess!
workspaceAccessWorkspaceAccess!
projectProject!
teamTeam!

PrometheusMetricSample

FieldTypeDescription
nameString!
labelsJSON!
valueFloat

PrometheusResult

FieldTypeDescription
textString!Raw Prometheus exposition text, ready for ingestion
samples[PrometheusMetricSample!]!Structured metric samples for programmatic access
familyCountInt!Number of metric families rendered
sampleCountInt!Number of individual samples rendered

Run

FieldTypeDescription
idID!
statusString!
messageString
isDestroyBoolean!
createdAtDateTime!
canceledAtDateTime
hasChangesBoolean!
autoApplyBoolean!
allowEmptyApplyBoolean!
allowConfigGenerationBoolean!
planOnlyBoolean!
sourceString!
statusTimestampsRunStatusTimestamps
triggerReasonString!
targetAddrs[String!]
replaceAddrs[String!]
permissionsRunPermissions!
actionsRunActions!
refreshBoolean!
refreshOnlyBoolean!
savePlanBoolean!
variables[String!]!
workspaceWorkspace
configurationVersionConfigurationVersion
applyApply
comments(filter: CommentFilter)[Comment!]!
runEvents[RunEvent!]!
runTriggers(filter: RunTriggerFilter)[RunTrigger!]!
planPlan
policyEvaluations(filter: PolicyEvaluationFilter)[PolicyEvaluation!]!
policyChecks(filter: PolicyCheckFilter)[PolicyCheck!]!

RunActions

FieldTypeDescription
isCancelableBoolean!
isConfirmableBoolean!
isDiscardableBoolean!
isForceCancelableBoolean!

RunEvent

FieldTypeDescription
idID!
bodyJSON!

RunPermissions

FieldTypeDescription
canApplyBoolean!
canCancelBoolean!
canCommentBoolean!
canDiscardBoolean!
canForceExecuteBoolean!
canForceCancelBoolean!
canOverridePolicyCheckBoolean!

RunStatusTimestamps

FieldTypeDescription
planQueueableAtDateTime

RunTrigger

FieldTypeDescription
idID!
workspaceNameString!
sourceableNameString!
createdAtDateTime!
workspaceWorkspace!
sourceableWorkspace!

SettingOverwrites

FieldTypeDescription
defaultExecutionModeBoolean
defaultAgentPoolBoolean

StateVersion

Remote Terraform state version data and metadata.

FieldTypeDescription
idID!
createdAtDateTime!
sizeInt
hostedJsonStateDownloadUrlString
hostedStateDownloadUrlString
hostedJsonStateUploadUrlString
hostedStateUploadUrlString
statusString
intermediateBoolean
modulesJSON
providersJSON
resourcesJSON
resourcesProcessedBoolean
serialInt
stateVersionInt
terraformVersionString
vcsCommitShaString
vcsCommitUrlString
billableRumCountInt
runRun
createdByUser
workspaceWorkspace
outputs[StateVersionOutput!]!

StateVersionOutput

FieldTypeDescription
idID!
nameString!
sensitiveBoolean!
typeString!
valueJSON!
detailedTypeJSON!
stateVersionStateVersion

Team

FieldTypeDescription
idID!
nameString!
ssoTeamIdString
usersCountInt!
visibilityString!
allowMemberTokenManagementBoolean!
permissionsTeamPermissions!
organizationAccessTeamOrganizationAccess!
organizationOrganization!
users(filter: UserFilter)[User!]!
usersFromAdmin(filter: UserFilter)[AdminUser!]
tokens(filter: TeamTokenFilter)[TeamToken!]!
workspaceAccess(filter: WorkspaceTeamAccessFilter)[WorkspaceTeamAccess!]!
projectAccess(filter: ProjectTeamAccessFilter)[ProjectTeamAccess!]!

TeamOrganizationAccess

FieldTypeDescription
managePoliciesBoolean
manageWorkspacesBoolean
manageVcsSettingsBoolean
managePolicyOverridesBoolean
manageModulesBoolean
manageProvidersBoolean
manageRunTasksBoolean
manageProjectsBoolean
manageMembershipBoolean
manageTeamsBoolean
manageOrganizationAccessBoolean
accessSecretTeamsBoolean
readProjectsBoolean
readWorkspacesBoolean
manageAgentPoolsBoolean

TeamPermissions

FieldTypeDescription
canUpdateMembershipBoolean
canDestroyBoolean
canUpdateOrganizationAccessBoolean
canUpdateApiTokenBoolean
canUpdateVisibilityBoolean
canUpdateNameBoolean
canUpdateSsoTeamIdBoolean
canUpdateMemberTokenManagementBoolean
canViewApiTokenBoolean

TeamToken

FieldTypeDescription
idID!
teamIdID!
createdAtDateTime!
lastUsedAtDateTime
descriptionString
tokenString
expiredAtDateTime
createdByIdID!

User

FieldTypeDescription
idID!
usernameString!
emailString
avatarUrlString
isServiceAccountBoolean!
authMethodString!
v2OnlyBoolean!
permissionsUserPermissions!
teams(includeOrgs: [String!], excludeOrgs: [String!], filter: TeamFilter)[Team!]!

UserPermissions

FieldTypeDescription
canCreateOrganizationsBoolean!
canViewSettingsBoolean!
canViewProfileBoolean!
canChangeEmailBoolean!
canChangeUsernameBoolean!
canChangePasswordBoolean!
canManageSessionsBoolean!
canManageSsoIdentitiesBoolean!
canManageUserTokensBoolean!
canUpdateUserBoolean!
canReenable2faByUnlinkingBoolean!
canManageHcpAccountBoolean!

Variable

FieldTypeDescription
idID!
keyString!
valueString
sensitiveBoolean!
categoryString!
hclBoolean!
createdAtDateTime!
descriptionString
versionIdString
workspaceWorkspace

VariableSet

FieldTypeDescription
idID!
nameString!
descriptionString
globalBoolean!
updatedAtDateTime!
varCountInt!
workspaceCountInt!
projectCountInt!
priorityBoolean!
permissionsVariableSetPermissions!
organizationOrganization
vars(filter: VariableFilter)[Variable!]
workspaces(filter: WorkspaceFilter)[Workspace!]
projects(filter: ProjectFilter)[Project!]

VariableSetPermissions

FieldTypeDescription
canUpdateBoolean!

Workspace

FieldTypeDescription
idID!
nameString!
descriptionString
lockedBoolean!
lockedReasonString
autoApplyBoolean!
createdAtDateTime!
updatedAtDateTime!
applyDurationAverageInt
planDurationAverageInt
policyCheckFailuresInt
queueAllRunsBoolean
resourceCountInt
runFailuresInt
sourceString
sourceNameString
sourceUrlString
speculativeEnabledBoolean
structuredRunOutputEnabledBoolean
tagNames[String!]!
terraformVersionString
triggerPrefixes[String!]!
vcsRepoJSON
vcsRepoIdentifierString
workingDirectoryString
workspaceKpisRunsCountInt
executionModeString
environmentString
operationsBoolean
fileTriggersEnabledBoolean
globalRemoteStateBoolean
latestChangeAtDateTime
lastAssessmentResultAtDateTime
autoDestroyAtDateTime
autoDestroyStatusString
autoDestroyActivityDurationInt
inheritsProjectAutoDestroyBoolean
assessmentsEnabledBoolean
allowDestroyPlanBoolean
autoApplyRunTriggerBoolean
oauthClientNameString
actionsWorkspaceActions
permissionsWorkspacePermissions
settingOverwritesWorkspaceSettingOverwrites
organizationOrganization
runs(filter: RunFilter)[Run!]!
configurationVersions(filter: ConfigurationVersionFilter)[ConfigurationVersion!]!
variables(filter: VariableFilter)[Variable!]!
stateVersions(filter: StateVersionFilter)[StateVersion!]!
currentStateVersionStateVersion
providers[WorkspaceProvider!]!
modules[WorkspaceModule!]!
projectProject
appliedPolicySets(filter: PolicySetFilter)[PolicySet!]!
currentRunRun
teamAccess(filter: WorkspaceTeamAccessFilter)[WorkspaceTeamAccess!]!
workspaceResources(filter: WorkspaceResourceFilter)[WorkspaceResource!]!

WorkspaceAccess

FieldTypeDescription
createBoolean!
moveBoolean!
lockingBoolean!
deleteBoolean!
runsString!
variablesString!
stateVersionsString!
sentinelMocksString!
runTasksBoolean!

WorkspaceActions

FieldTypeDescription
isDestroyableBoolean!

WorkspaceModule

FieldTypeDescription
nameString
versionString
sourceString

WorkspacePermissions

FieldTypeDescription
canUpdateBoolean!
canDestroyBoolean!
canQueueRunBoolean!
canReadRunBoolean!
canReadVariableBoolean!
canUpdateVariableBoolean!
canReadStateVersionsBoolean!
canReadStateOutputsBoolean!
canCreateStateVersionsBoolean!
canQueueApplyBoolean!
canLockBoolean!
canUnlockBoolean!
canForceUnlockBoolean!
canReadSettingsBoolean!
canManageTagsBoolean!
canManageRunTasksBoolean!
canForceDeleteBoolean!
canManageAssessmentsBoolean!
canManageEphemeralWorkspacesBoolean!
canReadAssessmentResultsBoolean!
canQueueDestroyBoolean!

WorkspaceProvider

FieldTypeDescription
nameString
versionString
sourceString

WorkspaceResource

FieldTypeDescription
idID!
addressString!
nameString!
createdAtDateTime!
updatedAtDateTime!
moduleString!
providerString!
providerTypeString!
modifiedByStateVersionStateVersion!
nameIndexString
workspaceWorkspace!

WorkspaceRunTrigger

FieldTypeDescription
idID!
workspaceNameString!
sourceableNameString!
createdAtDateTime!
workspaceWorkspace!
sourceableWorkspace!
inboundBoolean!

WorkspaceSettingOverwrites

FieldTypeDescription
executionModeBoolean
agentPoolBoolean

WorkspaceTeamAccess

FieldTypeDescription
idID!
accessString!
runsString!
variablesString!
stateVersionsString!
sentinelMocksString!
workspaceLockingBoolean!
runTasksBoolean!
teamTeam!
workspaceWorkspace!

AbstractRunTrigger

Inbound or outbound run-trigger connections between workspaces.

FieldTypeDescription
idID!
workspaceNameString!
sourceableNameString!
createdAtDateTime!
workspaceWorkspace!
sourceableWorkspace!

UserAccount

FieldTypeDescription
idID!
usernameString!
emailString
avatarUrlString
isServiceAccountBoolean!
teams(includeOrgs: [String!], excludeOrgs: [String!], filter: TeamFilter)[Team!]!

ExplorerFilterOperator

Value
is
is_not
contains
does_not_contain
is_empty
is_not_empty
gt
lt
gteq
lteq
is_before
is_after

ExplorerModuleField

Value
name
source
version
workspace_count
workspaces

ExplorerProviderField

Value
name
source
version
workspace_count
workspaces

ExplorerTerraformVersionField

Value
version
workspace_count
workspaces

ExplorerWorkspaceField

Value
all_checks_succeeded
current_rum_count
checks_errored
checks_failed
checks_passed
checks_unknown
current_run_applied_at
current_run_external_id
current_run_status
drifted
external_id
module_count
modules
organization_name
project_external_id
project_name
provider_count
providers
resources_drifted
resources_undrifted
state_version_terraform_version
tags
vcs_repo_identifier
workspace_created_at
workspace_name
workspace_terraform_version
workspace_updated_at

LogLevel

Value
TRACE
DEBUG
INFO
WARN
ERROR
JSON

MetricFormat

Value
PROMETHEUS
OPENMETRICS

TF_LOG_CATEGORY

Value
JSON
TRACE
DEBUG
INFO
WARN
ERROR